Go 语言的 go.mod 文件是 Go 模块系统的核心，它在 Go 1.11 中 Modules 模式 引入，用于支持版本控制和包依赖管理

go.mod 文件允许你明确指定项目所依赖的包及其版本号，Go 会根据这些版本信息下载适当的包版本，以确保项目的稳定性。

一、go.mod 文件结构

1、模块声明

module path: 指定模块的路径，这通常是版本控制仓库的地址

作用：标识模块的唯一性，并用于远程依赖查找。

module github.com/user/

2、Go 版本

go <version>: 指定用于编译该模块的 Go 语言的最低版本。

作用：确保模块使用的语言特性与指定的 Go 版本兼容。

go 1.21

3、依赖声明

require (<dependency-path> <version>): 列出模块依赖的其他模块及其版本，可以单行声明一个依赖，或者在一个 require 块中列出多个依赖。

作用：确控制项目依赖的版本，帮助保持构建的一致性

require github.com/go-sql-driver/mysql v1.7.0 // indirect

4、替换依赖包路径

replace <old-module-path> => <new-module-path> <version>: 用于替换依赖项，通常用于使用本地副本或者特定的分支、标签。

作用：便于开发者使用本地路径或不同源的模块，有助于调试或覆盖依赖。

replace github.com/pkg/errors v0.9.1 => github.com/pkg/errors v0.8.0
replace github.com/pkg/errors v0.9.1 => ../errors

5、排除某个依赖包

exclude <module-path> <version>: 用于排除特定版本的依赖项。

作用：避免使用特定版本的模块，常用于规避存在已知问题的版本。

exclude github.com/excluded/module v1.2.3

二、go.mod 文件初始化

在项目根目录下执行 go mod init 命令来初始化一个 go.mod 文件

go mod init

该文件中包含了项目的名称（也就是导入路径）和 Go 版本信息。

module example.com/myproject
go 1.18

三、go.mod 文件新增依赖

可以直接编辑 go.mod 文件新增依赖，也可以执行 go get 命令后，go.mod 文件也会自动新增一条依赖记录

go get github.com/user/package@v1.2.3

require (
    github.com/user/package v1.2.3
    // 其他依赖项...
)

go.mod 文件的使用极大地提升了 Go 项目的依赖管理能力，使得项目构建更加可靠

四、go.mod 文件清理不必要的依赖

可以直接编辑 go.mod 文件清理依赖，也可以执行 go mod tidy 命令

go mod tidy

go mod tidy 可以清理不再需要的依赖并更新 go.mod 文件